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PREFACE 


The User TELNET described in this document has been 
implemented within UCSB's Online System by Mark krilanovich 
and makes teletype-compatible time-sharing systems in the Net 


accessible to Online System users. 
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I Function 


This document describes a program whose function is to make 


an Online System terminal appear to any teletype-compatible, time- 


that svstem. By invoking this program from his terminal, an OLS 


user can effectively dial up a system at another site and use.it 
as if he were a local user of that system. The program performs 
the following major functions: 
1) ait resolves keyboard and display device 
incompatibilities, 
2) performs character set transformations, and 
3) makes its presence and chat of the Network 
transparent to the user, 
The. program which performs these functions is called a 


User TELNET. It operates in conjunction with another program 


called a Server TELNET executing at the site whose system is being 
used. A Server TELNIT exists at each. site whose system is 
accessible from the Net. Similarly, a User TELNET must exist at 
a site before users at that site have access to remote systems. 

User and Server TELNETs access the Net through their respective 
NCPs, 


the hand-shaking procedure by which the two parties connect them- 


and operate under a Network-standard protocol which specifies 


selves to one nother, as well as the format of data sent over a 
pair of Network connections established between them. A User TELNET 
makes such protocol considerations transparent to 1ts users. 

The TELNE] protocol is based upon the notion of a virtual 
teletype, emplcying a 7-bit ASCII character set. The primary 
function of a User TELNET, then, is to provide the means by which 
its users can ‘hit’ all the keys on that virtual teletype. I the 
user's keyboard happens in fact to actually be a teletype, then 
the mapping procedure is a very simple one. However, in UCSB's 
case, where a user's input device is an.OLS-keyboard (a device very 


different from a teletype), the mapping is more complex. 


The primary function of a Server TELNLT is to map the keys 
on the virtual teletype into that set of keys its local users 
can push on their keyboards. Again, if those keyboards are 
teletypes, the mapping done by the Server TELNET is straight- 
forwaru. In other cases, the task may be very complex. 

A Similar set of mappings transforms output generated by 
the remote system into a form displayable on the user's output 


device (in UCSB’ s case, this device is normally a storage scope). 


Is Invoking TELNET 


This and succeeding sections describe a preliminary version 
of a User. TELNET (hereafter referred to simply as TELNET) currently 
implemented within the Online System.  Tbis initial implementation 
does not provide all of the services that a final version must 
provide, nor does it provide all the conveniences that the next 
version will offer. It's a first pass which will bc upgraded in 
the near future. 

TELNET is accessible from NET, a subsystem (like MOLSF and 
COL) of OLS. A user is by default prohibited from loading NET. 

To have access to NET enabled tor his user number, a user need 
only contact the Computer Center. Assuming the foregoing, Net 


can be loaded with the key sequence: 


KEYBOARD ENTRY OLS QUERY/RESPONSE 
SYST | | /— WORK AREAS UPDATED 
LOAD NET LOAD NET 
RETURN FILE LOADED 
or by specifying the system name -'NET' at login. 
Once in NET, TELNET is invoked by :oing to Level II Real and 
hitting LOC. TELNET responds with a quory tor site number. The 


user should enter in decimal the number of the site (as indicated 
in Figure 1) to which he desires access; followed by RETURN. 


TELNET will then query the user for the Server TELNET'S socket 
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number. By convention, this number is normally 1, but in certain 
cases some other socket may be appropriate. In any case, the 


user should enter the socket number in decimal and hit RETURN. 


The dialogue, then, goes like this: 


KEYBOARD ENTRY OLS -QUERY/RESPONSE 

11 LOG FOREIGN SITE NO. = (site number) 
site number RETURN FOREIGN SCK NO. = 1 

1 RETURN 


When the second RETURN is depressed, TELNET will attempt to 
contact the designated Server TELNET and establish a duplex connec- 
tion for the user. Once the connection has been established, 
TELNET will erase the tube and position -the carriage to the upper 
left-hand corner of the screen. Fron this point on, the user is 
effectively connected to the remote system. TELNET enters a 
mode in which keys pushed by the user are mapped into their 
virtual-teletype equivalents and incoming text similarly trans- 
formed and displayed on the scope. If the remote system to which 
the user is connected normally issues a login message, that 
message will he the first to be displayed. In any case, the user 
Should proceed by logging in to the remote system according to 


the conventions appropriate to that system. 


III. The Virtual Teletype 


“The algorithm by which TELNET maps the OLS keyboard into the 
virtual teletype's character set, and by which it maps that same 
character set into the set of characters which can be displayed 
on the user's storage scope is defined in Figure 2. A line of 


that figure reads as follows: 


For line 11: 
The key labeled 'LF' (meaning 'Line Feed') on the 
virtual teletype, sometimes referred to as 'control-J', 


is struck by pressing either SUB, CASE J, or ¥ on an 


OLS keyboard. TELNET sends to the remote system an 
8-bit character with the value X'OA'. Whenever “LI! 
is received from the foreign system, TELNET displays 


it by rolling the carriage down one line. 


As indicated in the figure, CASE substitutes for the CNTRL 
key on a teletype. Hence, for example, 'control-C' is represented 
by the key pair ‘CASE C'. Note, however, that CASE and 'C' are hit 
in sequence, whereas on a teletype the CNTRL key is held down 


while 'C' is struck. 'CASE A'-' 'CASE Z'! each have an equivalent 


on the upper keyboard, and the position of that key on the upper 
keyboard corresponds to that of its counterpart on the lower 


keyboard. Hence, LS is equivalent to CASE A. 


Although TELNET provides the user with the means for 
transmitting both upper- and lower-case alphabetics (hitting 'A' 
sends a lower-case 'A'; holding down SHIFT and hitting 'A' sends 
upper-case 'A'), there is no provision in OLS for displaying 
lower-case characters on the storage scope. Hence, TELNET maps 
lower-case alphabetics into upper-case before displaying them. l 

The four virtual teletype keys 'ENQ', 'ACK', 'BEL', and 'NAK' 
are displayed by TELNET in «a special manner. Two lines are reserved 
for these characters at the top of the display area, and whenever 
TELNET receives such a character from the remote system, it displays 
it in its assigned position within the two-line field.  TELNET al- 
ways positions those four characters at the top of the display area, 
regardless of the user's current position on the scope, then 
returns to-it. 

A storage scope has both positive and negative attributes rel- 
ative to a teletype. Display is much quieter on a scope than on 
a teletype. However, the noise made by the return of a teletype 
carriage is ofven a valuable cue to the user, frequently signi- 


tying that the previous line of input from the user has been 


accepted by th» system. As a substitute for this particular cue, 
TELNET displays an underline ¢f ') at the left edge on the next 
line whenever it receives a carriage return (CR) from the remote 


systom. 
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Figure 2. TELNET Character Set 
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(continued) 
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Notes for Figure 2. TELNET Character Set 


All of the following keys send NULL: 

SET, CLR, €, Superscript U-9 
14A* is read 'Control At. Same for !'4B', '4C', etc. 
ENQ, ACK, BEL, and NAK are displayed as '<ENQ>', 
IXACK>"!, “'<BELL>', and '<NAK>', respectively, in an 
area at the top of the screen reserved especially for 


those characters. 


tA is sent by hitting the keys 'CASE' and 'A' in turn. 
Same for ^B, 4C, etc. 


Upper case 'A' is sent by holding down the SHIFT key 


while 'A' is struck. Same for upper case 'B', 'C*, otc. 


CR also causes an underline ' ' to be displayed in the 
left margin as 4 substitute for the often useful cue 
provided by the noisy return of a teletype carriage. 


11 


L2 


A storage scope is also a much faster display device than 
a teletype. However, in some situations this apparent attribute 
can be'troublesome. In particular, when a system displays a 
whole series of lines of text without requiring input from the 
user, the display may be wrapped around from the bottom of the 
scope to the top, and begin overlaying itself before the user has 
had time to read it all. In such cases, the following strategy 
is sometimes. useful (and will make sense once the next section-- 
Section IV--has been read): hit II before the display begins to 
wrap around upon itself; the display will stop. After the text 
has been read, erase the scope and hit LOG and display will resume. 

If the user hits ERASE while in TELNET, that key will have 
its usual effect; it will have no effect upon the remote system. 
However, because of a quirk in the current implementation of 
TELNET, ERASE will have the one additional effect of causing the 
display of incoming text to be suspended until another key on the 
virtual teletype is struck. The user is thus cautioned against 
erasing the scope while waiting for a resonse from the remote 
system. However, the user can extricate himself from the situation 


described by following the ERASE with. NUL on the virtual teletype. 


IV. Returning to TELNET. 


The user can at any time escape from TELNET (and hence from 
the remote system to which he is attached) by depressing à level 
key (e.g., I, o ered PES or, of course, by hitting 
RESET. Any tine thereafter, the user may return to TELNET by 
hitting 11 LOG (on NET) once aguin, and resume operation on his 
remote system exactiy where he left off. When 'II LOG' is pressed 
this second time, instead of querying the user for site number às 
before, TELNET will notice that the user is already connected to 


a remote system and simply resume where it left off. 
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After he escapes from TELNET and before he returns to it, 
the user may engage himself in any other Online System activity 
short of logging out, but including changing systems, while still 
retaining the option of subsequently returning to TELNET and 
resuming activity on the remote system to which he remains connected. 
The user can exploit this property of TELNET to obtain hard copy 
of a selected portion of his dialogue with the remote system. The 
user Simply brings his system to the point at which a listing is 
desired, escapes from TELNET by hitting ‘TYPE SEL 1,4 RETURN', 
thereby selecting the line printer as a secondary output device, 
and then returns to TELNET by pressing 'II LOG'. All subsequent 
communication with tho remote system w111 be recorded for eventual 
output on the printer. Logging off of OLS while escaped from 
TELNET causes the TELNET connection to be broken automatically by 


the system. 


V. Breaking TELNET Connections 


At any time while the user is in contact with TELNET, after 
the connection to the remote system has been established, the 
user may terminate that connection by hitting "CON RETURN”. 
TELNET will respond 'SOCKITS PURGED'. \ subsequent call to TELNET 
(i.c., a subsequent instance of '11l LOG') will illicit the 
original query for remote site number. The user is then free to 
connect himself to another foreign system. 

The user is cautioned that breaking Network connections 
as just described is not necessarily eqiivalent to logging out 
of the remote system. Some Server TELNZTs may, when they detect 
the breaking of connections, log the user off of their system; 
others may leave the user logged on.  Tne user should be aware 
of the convent. ons of the systems he uses and, where appropriate, 
log himself of: before breaking connections. 


The key sequence 'I DEL RETURN! will also terminate a TELNET 
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connection, but ail other connections that may have been previously 


established using the operators of Level 1 are closed as well. 


VI. Abuormal Network Conditions 


While the user is in TELNET and attuched to a remote system, 
TELNET monitors the user's Network connections. If any abnormal 


condition is detected, it terminates its monitoring and issues a 


message of tho form: 


CONNECT 
INPUT ERROR - CODE- n 
OUTPUT 
where 'n' is one of the values listed in Figures 3-5. A CONNECT 


error may occur during TELNET's initial attempt to establish 
connections to the remote system; an INPUT error may occur when 
TELNET attempts to extract incoming data from the Net; and an 
OUTPUT error may occur as TELNET tries to insert outgoing data 


into the Net. 
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Figure 3. CONNECT ERROR CODES 


A previous invokation of TELNET left a local receive 
socket open; the send socket as closed. Hit *] DEL 
RETURN. 

A previous invokation of TELNET aborted, and 'I DEL 
RETURN! failed to close the Network connections. ‘The 


remote site is probably dead. 


All communication paths between UCSB and the specified 
remote site are in use. 


UCSB's NCP is running at capacity or is drained or 


stopped. 


The connection attempt was refused by the remote site. 
No such remote site. 

Remote site was discovered to be dead. 

The Operator has stopped or reset the NCP. 

Either the specified remote site is not accepting 
input from the Net, or there was a failure in the 


subnet. 


The specified remote site has broken all existing 
connections to UCSB. 


The remote site is known to be dead. 
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Figure 4. INPUT ERROR CODES 


Connections to the Server TELNET at the remote site 
have been broken. 7 


Connections to the Server TELNET at the remote site 
are being broken. 


An interrupt was sent by the remote system. Resume 
by hitting LOG. 


64 


68 


Figure 5. OUTPUT ERROR CODES 


Connections to the Server TELNET at the remote site 
have been broken. É 


Connections to the Server TELNET at the remote site. 


are being broken. 

same as 8. 

Remote site has died. 

The Operator has stopped or reset the NCP. 


1 


An interrupt was sent by the remote system. Resume 
by hitting LOG. f 


Either the remote site has stopped accepting input 
from the Net or there was a failure in the subnet. 


same as 60. 


The remote site has broken all existing connections 
to UCSB. 
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